home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / editor / htmst707.zip / MOZ.DOC < prev    next >
Text File  |  1997-07-31  |  12KB  |  246 lines
  1. MOZ.DOC                                1                           Jul 31, 1997
  2.  
  3. The MOZ program processes your Netscape Web cache, renaming or copying files so
  4. their file names correspond to the original names they had on  the  originating
  5. site.  Features of this program:
  6.  
  7.   * Renames or copies all of the files in the cache.
  8.   * Should work for the caches from version 2.0 of Netscape.
  9.   * Was originally written  to  handle  Mosaic  caches  version  2.0  or  above
  10.     although I don't use Mosaic anymore so I have no idea if  it  still  works.
  11.     Someone told me it didn't work with the Spry version.  Sorry!
  12.   * Renames each file (with  file  names  like  M0OSOSFD.GIF)  to  match  their
  13.     original names on the originating site as closely as possible (so this file
  14.     might end up being BATMAN.GIF).
  15.   * If there are files with duplicate source names, it renames according  to  a
  16.     sequential system (BATMAN01.GIF, BATMAN02.GIF, etc).
  17.   * Reads each of the files in the cache and determines  the  file  type.  File
  18.     types can be any of the following:
  19.       AU  (sound files)
  20.       BMP (graphic files)
  21.       DCR (Shockwave plug-in)
  22.       EXE (compiled programs)
  23.       GIF (graphic files)
  24.       HTM (HTML files)
  25.       JPG (graphic files)
  26.       MID (sound files)
  27.       PDF (Adobe Acrobat)
  28.       WAV (sound files)
  29.       ZIP (compressed files)
  30.     Renames the file extension according to the file type.
  31.   * Optionally renames what's left as *.WHO files.
  32.   * Files marked read-only, system, or hidden are ignored during renaming.
  33.   * When the /RENAME option is used, a fail-safe file called C:\MOZBACK.BAT is,
  34.     by default, created which contains all of the RENAME commands necessary  to
  35.     rename everything back the way it was.
  36.   * Can be used to create an HTML file linked to all of the GIF and  JPG  files
  37.     in the subdirectory.  In Netscape, you would then use File | Open  File  to
  38.     load this HTML page and then you would see all  of  the  graphics  in  your
  39.     cache full size and they would be identified on the screen.
  40.   * Following up on the latter point, you can use  this  feature  without  even
  41.     having a cache subdirectory of images.  Just collect some GIF or JPG images
  42.     in your default subdirectory and then issue the following command:
  43.        MOZ /SKIP /SLIDE /ALL
  44.     This will create an HTML document which you can File | Open  File  and  see
  45.     everything you have.
  46.   * Pressing escape stops the program early.
  47.  
  48. Note:  You should not run this command while your Web browser is running as  it
  49. won't be able to open the necessary cache management  file.   The  /ALL  option
  50. will still work but none of the external links will be identified.
  51.  
  52.  
  53.  
  54. MOZ.DOC                                2                           Jul 31, 1997
  55.  
  56. Specifying parameters:
  57.  
  58. Parameters for this program can be set in the following ways.  The last setting
  59. encountered always wins:
  60.   - Read from an *.INI file (see BRUCEINI.DOC file),
  61.   - Through the use of an environmental variable (SET MOZ=whatever), or
  62.   - From the command line (see "Syntax" below)
  63.  
  64.  
  65. Syntax:
  66.  
  67.     MOZ [ path | /Cpath ] { /COPY=path | /RENAME | /SKIP } [ /CREATE ] [ /ALL ]
  68.       [ /WHO ] [ /-MOZBACK | /MOZBACK | /MOZBACK=filename ]
  69.       [ /-SLIDE | /SLIDE | /SLIDE=filename ]
  70.       [ /OVERWRITE | /-OVERWRITE | /OVERASK ] [ /DEBUG ]
  71.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ]
  72.  
  73. where:
  74.  
  75. "path" (or "/Cpath") is where the files are found.  If no path is provided, the
  76. program defaults to looking in the following locations in sequence:
  77.  
  78.         default subdirectory
  79.         C:\NETSCAPE\CACHE
  80.         C:\MOSAIC\CACHE
  81.         D:\NETSCAPE\CACHE
  82.         D:\MOSAIC\CACHE
  83.  
  84. The  first  subdirectory  that  exists  and  contains  any  files  meeting  the
  85. specification *.MO* or M0*.* will be the one processed by the command.
  86.  
  87. "/COPY=path" specifies that the processed files are to be  copied  under  their
  88. new names to the specified output subdirectory, not  renamed  in  the  existing
  89. subdirectory.  If no subdirectory is specified (that is, just "/COPY" is passed
  90. in), you will be prompted for one.  If the subdirectory  does  not  exist,  you
  91. will be prompted for whether to create it or not based  on  the  value  of  the
  92. /CREATE parameter.
  93.  
  94. "/RENAME" specifies that the files are to be renamed instead of  copied.   This
  95. works great unless you specify it by mistake.  Even  then,  the  /MOZBACK  file
  96. will allow you to backtrack although the MOZBACK file gets wiped out the second
  97. time through.
  98.  
  99. "/SKIP" doesn't bother doing any renaming or  copying  with  the  files.   It's
  100. mainly used when you want the program to create an HTML page with the  relevant
  101. graphics.
  102.  
  103. "/CREATE" automatically  creates  the  output  subdirectory  if  /COPY=path  is
  104. specified.  The default is "/-CREATE"; if the subdirectory is  not  there,  the
  105. program prompts whether it should be created or not.
  106.  
  107.  
  108. MOZ.DOC                                3                           Jul 31, 1997
  109.  
  110. "/ALL" renames all files in the  cache,  whether  they're  in  the  Web-created
  111. directory file (for example, FAT.DB) or not.  Note that  if  your  Web  browser
  112. GPF'ed or something nasty while you were running it, the  FAT.DB  file  may  be
  113. incomplete or even missing.  /ALL allows  the  orphan  files  to  be  processed
  114. somewhat.  Files matching either  *.MO*  (Mosaic's  default  filter)  or  M0*.*
  115. (Netscape's default filter) will be renamed sequentially starting  with  _000.*
  116. if /ALL is specified.  Initially, the default is "/-ALL".
  117.  
  118. "/-ALL" skips processing files that aren't identified in the  cache  directory.
  119. This is initially the default.
  120.  
  121. "/WHO" tells the program to rename (if /RENAME used) any unexpected file  types
  122. as *.WHO.  (The program auto-detects certain file types but not some unexpected
  123. ones  that  Netscape  might  toss  in  your  cache  subdirectory.)   Otherwise,
  124. unexpected file types are left with their original extension.  For example, you
  125. download  a  Netscape's  initialization  file  (NETSCAPE.INI).   If   /WHO   is
  126. applicable, the file is renamed NETSCAPE.WHO.  If /-WHO is applicable, the file
  127. is renamed NETSCAPE.INI.  Initially defaults to "/-WHO".
  128.  
  129. "/-WHO" tells MOZ to not change the file extension  of  files  with  unexpected
  130. file types when it encounters on..  This is initially the default.
  131.  
  132. "/-MOZBACK" skips creating a back-out file.  The back-out batch file, available
  133. only when /RENAME is in effect, consists of a series of  RENAME  commands  that
  134. reverses the changes that were just made.  The initial default is "/MOZBACK".
  135.  
  136. "/MOZBACK" creates the back-out file as C:\MOZBACK.BAT and is the same thing as
  137. specifying /MOZBACK=C:\MOZBACK.BAT.  This file is only created  if  /RENAME  is
  138. used.  This is initially the default.
  139.  
  140. "/MOZBACK=filename" creates the back-out  file  under  the  specified  filename
  141. instead of using the  default  filename  C:\MOZBACK.BAT.   This  file  is  only
  142. created if /RENAME is used.  If  the  filename  exists  already,  you  will  be
  143. prompted to  overwrite  it  or  not  depending  on  the  value  of  /OVERWRITE,
  144. /-OVERWRITE, and /OVERASK.
  145.  
  146. "/-SLIDE" skips creating an HTML file that  loads  each  of  the  GIF  or  JPEG
  147. graphic files in the given cache directory.  This is initially the default.
  148.  
  149. "/SLIDE" creates an HTML file named C:\MOZ.HTM which consists of  a  series  of
  150. <IMG SRC=filename> specifications for each of the GIF or JPEG graphic files  in
  151. the given cache directory.  When you view this file using File | Open  File  in
  152. Netscape (or a similar command in other browsers), all  of  the  graphic  files
  153. will be loaded onto your screen for you to  view.   "/SLIDE"  is  the  same  as
  154. entering "/SLIDE=C:\MOZ.HTM".  You can have the program do a slide show for all
  155. GIF/JPEG's in your subdirectory (whether they were part of the cache or not) by
  156. saying:
  157.         MOZ subdir /SLIDE /ALL /SKIP
  158. where "subdir" is where those files are saved.
  159.  
  160. "/SLIDE=filename" creates the HTML file under the specified filename instead of
  161. using the default filename C:\MOZ.HTM.  If the  filename  exists  already,  you
  162. will be prompted to overwrite it or not depending on the value  of  /OVERWRITE,
  163. /-OVERWRITE, and /OVERASK.
  164.  
  165.  
  166. MOZ.DOC                                4                           Jul 31, 1997
  167.  
  168. "/OVERWRITE" says that if either of the output files exist  already  (depending
  169. on the value of /SLIDE and /MOZBACK), don't prompt before overwriting it.
  170.  
  171. "/-OVERWRITE" says to abort if either of the output files exist already.
  172.  
  173. "/OVERASK" says to prompt if either of the output files exist already.  This is
  174. initially the default.
  175.  
  176. "/DEBUG" tells you what it would rename  everything  but  doesn't  actually  do
  177. anything.
  178.  
  179. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  180. defaults to "/COLOR".
  181.  
  182. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  183. initially the default.
  184.  
  185. "/Iinitfile" says to read an initialization file with the file name "initfile".
  186. The file specification *must* contain a period.  Initfiles are described in the
  187. BRUCEINI.DOC file.  Initially defaults to "/IMOZ.INI".
  188.  
  189. "/-I" (or "/INULL") says to skip loading the initialization file.
  190.  
  191. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  192. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  193. more information.  This is initially the default.
  194.  
  195. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  196. Initially defaults to "/ENV".
  197.  
  198. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  199.  
  200.  
  201. Return codes:
  202.  
  203. MOZ returns the following ERRORLEVEL codes:
  204.  
  205.         0 = no problems, all files processed
  206.       251 = could not find a file to process
  207.       252 = encountered errors while copying/renaming
  208.       253 = operation aborted by pressing Escape
  209.       254 = output files existed already and overwriting not allowed
  210.       255 = syntax problems, or /? requested
  211.  
  212.  
  213.  
  214. MOZ.DOC                                5                           Jul 31, 1997
  215.  
  216. Author:
  217.  
  218. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  219. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  220. program, no changes are made to the program or documentation,  and  it  is  not
  221. bundled with commercial programs or charged for separately.  People who need to
  222. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  223. Software" at the following address.
  224.  
  225. Additional information about this and other  Wayne  Software  programs  can  be
  226. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  227. The recent change history for this and the other programs is  provided  in  the
  228. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  229. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  230. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  231. naming the ZIP file (HTMSTymm.ZIP) that this program was included in.
  232.  
  233. Comments and suggestions can also be sent to:
  234.  
  235.                 Bruce Guthrie
  236.                 Wayne Software
  237.                 113 Sheffield St.
  238.                 Silver Spring, MD 20910
  239.  
  240.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  241.                 http://www.geocities.com/SiliconValley/Lakes/2414
  242.  
  243. Please provide an Internet e-mail address on all correspondence.
  244.  
  245. 
  246.